OLA 文档中心

主题

2026-07-25

修改数据库密码 - ChangeDatabasePassword ​

函数简介 ​

修改已加密 SQLite 数据库的密码。基于 SQLCipher 的 PRAGMA rekey 实现，必须提供正确的旧密码。

接口名称 ​

ChangeDatabasePassword

DLL调用 ​

c
int ChangeDatabasePassword(long ola, string dbName, string oldPassword, string newPassword);

参数说明 ​

参数名类型说明
ola长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
dbName字符串数据库文件路径。
oldPassword字符串当前数据库密码。
newPassword字符串新数据库密码；传空字符串可移除加密。

示例 ​

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
int ret = ola.ChangeDatabasePassword("data/app.db", "old_pwd", "new_pwd");
if (ret != 0) {
    long db = ola.OpenDatabase("data/app.db", "new_pwd");
    if (db != 0) {
        ola.CloseDatabase(db);
    }
}
csharp
using OLAPlug;

var ola = new OLAPlugServer();
int ret = ola.ChangeDatabasePassword("data/app.db", "old_pwd", "new_pwd");
if (ret != 0)
{
    long db = ola.OpenDatabase("data/app.db", "new_pwd");
    if (db != 0)
    {
        ola.CloseDatabase(db);
    }
}
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
ret = ola.ChangeDatabasePassword("data/app.db", "old_pwd", "new_pwd")
if ret != 0:
    db = ola.OpenDatabase("data/app.db", "new_pwd")
    if db != 0:
        ola.CloseDatabase(db)
java
import com.olaplug.OLAPlugServer;

OLAPlugServer ola = new OLAPlugServer();
int ret = ola.ChangeDatabasePassword("data/app.db", "old_pwd", "new_pwd");
if (ret != 0) {
    long db = ola.OpenDatabase("data/app.db", "new_pwd");
    if (db != 0) {
        ola.CloseDatabase(db);
    }
}
go
import "github.com/ola/olaplug/olaplug"

ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
ret := ola.ChangeDatabasePassword("data/app.db", "old_pwd", "new_pwd")
if ret != 0 {
    db := ola.OpenDatabase("data/app.db", "new_pwd")
    if db != 0 {
        ola.CloseDatabase(db)
    }
}
rust
use olaplug::OLAPlugServer;

let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
let ret = ola.change_database_password("data/app.db", "old_pwd", "new_pwd");
if ret != 0 {
    let db = ola.open_database("data/app.db", "new_pwd");
    if db != 0 {
        ola.close_database(&db);
    }
}
cpp
var ola = com("OlaPlug.OlaSoft")
var ret = ola.ChangeDatabasePassword("data/app.db", "old_pwd", "new_pwd")
if(ret) {
    var db = ola.OpenDatabase("data/app.db", "new_pwd")
    if(db) {
        ola.CloseDatabase(db)
    }
}
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
ret = ola.ChangeDatabasePassword("data/app.db", "old_pwd", "new_pwd")
If ret <> 0 Then
    db = ola.OpenDatabase("data/app.db", "new_pwd")
    If db <> 0 Then
        ola.CloseDatabase(db)
    End If
End If
text
.局部变量 ola, OLAPlug
ola.创建 ()
ret ＝ ola.ChangeDatabasePassword (“data/app.db“, “old_pwd“, “new_pwd“)
.如果真 (ret ≠ 0)
    db ＝ ola.OpenDatabase (“data/app.db“, “new_pwd“)
    .如果真 (db ≠ 0)
        ola.CloseDatabase (db)
    .如果真结束
.如果真结束
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var ret = ola.ChangeDatabasePassword("data/app.db", "old_pwd", "new_pwd");
if(ret){
    var db = ola.OpenDatabase("data/app.db", "new_pwd");
    if(db){
        ola.CloseDatabase(db);
    }
}
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
整数 ret = ola.ChangeDatabasePassword("data/app.db", "old_pwd", "new_pwd")
如果真 (ret ≠ 0)
{
    长整数 db = ola.OpenDatabase("data/app.db", "new_pwd")
    如果真 (db ≠ 0)
    {
        ola.CloseDatabase(db)
    }
}
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
int ret = ola.ChangeDatabasePassword("data/app.db", "old_pwd", "new_pwd");
if (ret != 0) {
    long db = ola.OpenDatabase("data/app.db", "new_pwd");
    if (db != 0) {
        ola.CloseDatabase(db);
    }
}

原生 DLL 调用 ​

cpp
long instance = CreateCOLAPlugInterFace();
int ret = ChangeDatabasePassword(instance, "data/app.db", "old_pwd", "new_pwd");
if (ret != 0) {
    long db = OpenDatabase(instance, "data/app.db", "new_pwd");
    if (db != 0) {
        CloseDatabase(instance, db);
    }
}
csharp
using System.Runtime.InteropServices;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();

long instance = CreateCOLAPlugInterFace();
int ret = ChangeDatabasePassword(instance, "data/app.db", "old_pwd", "new_pwd");
if (ret != 0)
{
    long db = OpenDatabase(instance, "data/app.db", "new_pwd");
    if (db != 0)
    {
        CloseDatabase(instance, db);
    }
}
python
from ctypes import CDLL, c_int, c_int64

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
ret = ola.ChangeDatabasePassword(instance, b"data/app.db", b"old_pwd", b"new_pwd")
if ret:
    db = ola.OpenDatabase(instance, b"data/app.db", b"new_pwd")
    if db:
        ola.CloseDatabase(instance, db)

返回值 ​

返回值说明
1成功。
负数失败；绝对值为错误码。与 GetLastError() 一致。

完整错误码表见 数据库错误码说明。

失败时可调用 GetLastErrorString() 获取中文说明。

注意事项 ​

项目说明
旧密码必须正确，否则无法修改。
已有连接若该库文件已有打开的连接，会先自动关闭后再修改密码。
句柄失效修改成功后原 db 句柄已失效，需用新密码重新 OpenDatabase。
默认库若修改的是 设置 中的默认库（DbPath 且密码匹配），会自动更新 DbPassword 并清空 DbPtr。
移除加密newPassword 传空字符串可移除数据库加密。
内存库本接口仅适用于磁盘文件；内存库不支持。
句柄方式若数据库已打开，推荐使用 ChangeDatabasePasswordFromPtr，无需旧密码且句柄保持有效。